home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Camelot / Camelot 134 (1991-10)(Swedish User Group of Amiga)(SE)(PD)[WB].zip / Camelot 134 (1991-10)(Swedish User Group of Amiga)(SE)(PD)[WB].adf / SCSIMounter / scsimounter.doc < prev    next >
Text File  |  1991-07-27  |  10KB  |  337 lines
  1. SCSIMounter 1.0
  2. ===============
  3. (Document Revision 0.41)
  4.  
  5. Removable media partition mounter for Kickstart 2.0 or higher.
  6.  
  7.  
  8. ------------------------------------------------------------------------
  9. Disclaimer
  10. ----------
  11.  
  12. SCSIMounter may be freely distributed for non-commercial purposes only. 
  13. The entire risk as to the quality and performance of this program is 
  14. with you. 
  15.  
  16. The author assumes no responsibility or liability whatsoever with
  17. respect to your use or inability to use of this software.
  18.  
  19.  
  20. ------------------------------------------------------------------------
  21. Purpose
  22. -------
  23.  
  24. Most owners of removable media SCSI drives are stuck with the problem
  25. that their software doesn't handle disk changes correctly.
  26. For example, the current Commodore implementation doesn't mount the 
  27. partitions on a removable media SCSI drive (e.g. SyQuest or Ricoh)
  28. when there was no cartridge in the drive at boot time. 
  29.  
  30. Even worse, after another cartridge with a different Rigid Disk Block 
  31. (i.e. a different partition table) has been inserted, the system
  32. gets totally confused and reports read/write errors when trying
  33. to access the device which can lead to loss of important data on 
  34. the cartridge.
  35.  
  36. Until now, the only possibility to work around this problem was to
  37. reboot the system every time a new cartridge has been inserted.
  38.  
  39. SCSIMounter allows you to mount and unmount partitions without rebooting 
  40. the machine. It sports a nice 2.0-style point-and-click user interface
  41. that makes handling removable media a piece of cake.
  42.  
  43.  
  44. ------------------------------------------------------------------------
  45. Secondary use
  46. -------------
  47.  
  48. SCSIMounter can also be used to mount partitions that have intentionally
  49. not been mounted (e.g. the wb_1.3: partition on an A3000 when running 
  50. under 2.0). You don't have to create a mountlist for it! 
  51.  
  52.  
  53. ------------------------------------------------------------------------
  54. Requirements
  55. ------------
  56.  
  57. · Any Amiga with a SCSI host adaptor that supports the Commodore
  58.   RDB (Rigid Disk Block) and 'SCSI Direct' standards.
  59. · Kickstart 2.0 or higher
  60.  
  61. The program has been tested on an A3000 with Commodore's scsi.device
  62. and on an A2500 with a Microbotics HardFrame (HardFrame.device) but
  63. I see no reason why it shouldn't work on any other host adaptor. 
  64.  
  65. ! Since there are so many different host adaptors with devices that behave
  66. ! totally different, I need to know your experiences. Please don't hesitate
  67. ! to contact me in case of a problem with your controller card. I'll be 
  68. ! glad to fix the problem and send you a revised version of SCSIMounter.
  69.  
  70. The program may be of no use for owners of certain GVP controllers 
  71. which support removable media correctly (Though not all GVP software 
  72. might do so).
  73.  
  74.  
  75. ------------------------------------------------------------------------
  76. Before you begin
  77. ----------------
  78.  
  79. First, determine the name of the device driver of your hard disk 
  80. controller card. 
  81.  
  82.     Examples of popular controllers and their devices:
  83.  
  84.     manufacturer/controller           device
  85.     --------------------------------------------------
  86.     Commodore A590/A2091/A3000        scsi.device
  87.     Old GVP                           scsidev.device
  88.     Supra SupraDrive                  harddisk.device
  89.     Advanced Storage Systems Nexus    nexus.device
  90.     Microbotics HardFrame             HardFrame.device
  91.     ICD AdSCSI                        icddisk.device
  92.     IVS Trumpcard Professional        ivs_scsi.device
  93.     --------------------------------------------------
  94.  
  95. Click once one the SCSIMounter icon and select 'Information' from the
  96. 'Icons' menu.
  97.  
  98. Add or change the following tool type:
  99.  
  100.     DEVICE=Name_of_your_scsi_device_here
  101.  
  102. for example if you use a HardFrame controller write:
  103.  
  104.     DEVICE=HardFrame.device
  105.  
  106. Don't add path names here, only the name of the device is required.
  107. Take care to capitalize the device name correctly (exec device names 
  108. are case sensitive!)
  109.  
  110. NOTE
  111.  
  112. SCSIMounter will not work with the Commodore A2090(A) controller card
  113. because this product does not support Commodore's own 'SCSI direct' and
  114. 'RDB' standards properly.
  115.  
  116.  
  117. ------------------------------------------------------------------------
  118. Start SCSIMounter
  119. -----------------
  120.  
  121. SCSIMounter can be used either from Workbench or from the CLI.
  122.  
  123.  
  124. * Workbench use
  125.  
  126.   Double click on the SCSIMounter icon. After a short time, a window
  127.   with a listview and three buttons will appear. If the window doesn't
  128.   appear several things could have gone wrong:
  129.  
  130.   · Do you use Kickstart 2.0 or higher?
  131.   · Did you specify and spell the name of your device driver correctly?
  132.   · Does your host adaptor support RDB?
  133.   · Is there any memory left on your system?
  134.  
  135.   Requesters will try to tell you the cause if SCSIMounter fails to run.
  136.  
  137.  
  138. * CLI use
  139.  
  140.   Type 'SCSIMounter Name_of_your_scsi_device'
  141.   example:
  142.  
  143.   1> SCSIMounter HardFrame.device
  144.  
  145.   If no argument is given, SCSIMounter uses the default A3000/A2091/A590
  146.   device driver (scsi.device)
  147.  
  148.  
  149. ------------------------------------------------------------------------
  150. Panels
  151. ------
  152.  
  153. 1) Main panel
  154.  
  155.    The main panels shows all devices connected to the SCSI port with
  156.    information about their capacity and current status. The currently 
  157.    selected unit is higlighted.
  158.  
  159.    UNIT - This is the unit number of a SCSI device.
  160.           Up to seven devices can be connected to the SCSI bus
  161.  
  162.    DRIVE TYPE - Manufacturer and product specification
  163.  
  164.    REV. - Revision of Hardware, Firmware and ROM of device
  165.  
  166.    CAP. - Device capacity in Megabytes or Kilobytes
  167.  
  168.    STATUS - Current Status of device. If the device is busy or
  169.             not accessable due to the lack of media (if it's a
  170.             removable media drive) the status will be set to
  171.             'not ready'
  172.  
  173.    There are three 'action buttons' present:
  174.  
  175.    QUIT - Quit SCSIMounter
  176.  
  177.    UPDATE - Re-scan SCSI bus and update display
  178.  
  179.    MOUNT - Mount partitions on selected drive
  180.  
  181.    For every action buttons there's also a menu item with identical
  182.    function.
  183.  
  184.  
  185. 2) 'Partition Selector' panel
  186.  
  187.    This panel shows all available partitions and allows you to 
  188.    individually mount them.
  189.  
  190.    CHECKGADGETS - Determine if the particular partition should 
  191.                   be mounted or not.
  192.  
  193.                   checked: mount corresponding partition
  194.                   not checked: don't mount specified partition
  195.  
  196.  
  197.    Other partition Information on the partition selector -
  198.  
  199.           Device name of partitions
  200.  
  201.           Size of partitions
  202.  
  203.           Dostype (FileSystem) of partition
  204.  
  205.              Examples of dostypes:
  206.  
  207.              DOS0 - Old filesystem partition
  208.              DOS1 - FastFileSystem partition
  209.              UNI1 - Unix boot partition
  210.              RESV - Reserved partition
  211.  
  212.    CANCEL - Go back to main panel, don't mount anything
  213.  
  214.    MOUNT - Unmount all currently mounted partitions on the selected
  215.            device and mount the new partitions (if any).
  216.  
  217.    UNMOUNT ALL - If this gadget is checked, SCSIMounter will try
  218.                  to unmount all partitions currently mounted on the
  219.                  selected unit. If there are locks on this device
  220.                  there will be a 'BUSY' icon on your Workbench screen.
  221.  
  222.  
  223. ------------------------------------------------------------------------
  224. Operation
  225. ---------
  226.  
  227. SCSIMounter is pretty self-explanatory. Nevertheless, here are some 
  228. basic operation procedures.
  229.  
  230. * Mount a new cartridge
  231.  
  232.   · Click on the listview entry of the desired device. (Make sure its
  233.     status is 'ready')
  234.  
  235.   · Click on the 'Mount' button
  236.  
  237.     The 'select partitions' panel will ask you which partitions to mount
  238.  
  239.   · Chosse the partitions you would like to mount
  240.  
  241.   · Make sure that the 'Unmount all' gadget is checked
  242.  
  243.   · Click on 'Mount' button on the partition selector panel
  244.  
  245.     SCSIMounter will automatically unmount all existing partitions
  246.     on the device and mount the new partitions.
  247.  
  248.  
  249. * Add a drive
  250.  
  251.   · Click on the 'Update' button
  252.  
  253.     The new drive's name and other information  should appear in the 
  254.     listview
  255.  
  256.   · Click on the corresponding entry
  257.   · Click on the 'Mount' button
  258.  
  259.     and so on...
  260.  
  261.  
  262. WARNING !!!
  263.  
  264.     Don't unmount your boot partition (where you system files live) or
  265.     you'll soon be forced to reboot you machine...
  266.  
  267.  
  268. ------------------------------------------------------------------------
  269. Keyboard Equivalents
  270. --------------------
  271.  
  272. * Requesters
  273.  
  274.   OK             Rt. Amiga-O
  275.   Cancel         Rt. Amiga-C
  276.  
  277.  
  278. * Main window & Project menu
  279.  
  280.   About          Rt. Amiga-A
  281.   Mount          Rt. Amiga-M
  282.   Update         Rt. Amiga-U
  283.   Quit           Rt. Amiga-Q
  284.  
  285.  
  286. * Partition Selector
  287.  
  288.   Mount          Rt. Amiga-M
  289.   Cancel         Rt. Amiga-C
  290.   Select All     Rt. Amiga-A
  291.   Unselect All   Rt. Amiga-U
  292.  
  293.  
  294. ------------------------------------------------------------------------
  295. Known Problems
  296. --------------
  297.  
  298. · The program only removes the dos entries for the volumes and devices.
  299.   It doesn't remove the filesystem process and associated memory 
  300.   allocations. Apparently the current FS doesn't support the ACTION_DIE
  301.   packet. I'm still looking for a legal way to solve this problem.
  302.  
  303.  
  304. ------------------------------------------------------------------------
  305. Credits
  306. -------
  307.  
  308. Author: Martin A. Blatter
  309.         Pfaffächerstr. 59
  310.         CH-8913 Ottenbach
  311.         Switzerland
  312.  
  313. E-Mail: blatter@amiga.physik.unizh.ch
  314.         blatter%zethos@cbmswi.commodore.com
  315.  
  316. Phone:  ++41 1 761 20 02
  317.  
  318. Bug reports or suggestions are welcome. If you find this program useful,
  319. feel free to send a donation to the above address.
  320.  
  321. This program uses ITools, the object-oriented user interface system
  322. (c) 1991 by Christian A. Weber.
  323.  
  324. Special thanks to  · Christian A. Weber
  325.                    · Peter Simeon for the SCSI inquiry code
  326.                    · Michael Sinz for the 2.0 Workbench busy image :-)
  327.                    · Eric Giguere
  328.  
  329. ------------------------------------------------------------------------
  330. Trademarks
  331. ----------
  332.  
  333. All trademarked product and company names used herein are used for
  334. identification purposes only. No infringement of trademarks is intended.
  335. Trademarks remain property of the trademark holder.
  336.  
  337.